[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
##############################################################################
###+-----+####################################################################
#+-| SAY |--------------------------------------------------+#################
#| +-----+ The SAY subcommand prints a character string to  |#################
#|         the device selected in the SET DEVICE TO command |#################
#+----------------------------------------------------------+#################
##############################################################################
##############################################################################
#+--| Syntax |---------------------------------------------+##################
#|     @<Int-exp,Int-exp> SAY <C-exp> [PICTURE <C-exp>     |##################
#|     || FUNCTION <C-exp> ]                               |##################
#+---------------------------------------------------------+##################
##############################################################################
##############################################################################
#######+---| Description |--------------------------------------------+#######
#######| The SAY subcommand prints a character string to the device   |#######
#######| selected in the SET DEVICE TO command.  The character        |#######
#######| string can be filtered through a template using the PICTURE  |#######
#######| or FUNCTION clauses.                                         |#######
#######| ------------------------------------------------------------ |#######
#######| The SAY subcommand should be used only when formatted output |#######
#######| or an accompanying GET is required.  The efficient @...??    |#######
#######| command provides faster screen output.                       |#######
#######| ------------------------------------------------------------ |#######
#######| SAY does not interpret editing, line control or page control |#######
#######| characters implicitly; e.g., the tab character, ASCII 9, is  |#######
#######| not handled as a tab.  Neither are the carriage return or    |#######
#######| line feed characters.  No implicit control is attached to    |#######
#######| characters presented to SAY.                                 |#######
#######| ------------------------------------------------------------ |#######
#######| Character strings exceeding the remaining number of column   |#######
#######| positions on the row automatically wrap to the next row.     |#######
#######| The column position for the next row is adjusted to 0.       |#######
#######| However, SAY will not scroll the screen.                     |#######
#######| ------------------------------------------------------------ |#######
#######| SAY determines the output length of the character string in  |#######
#######| the following priority:                                      |#######
#######|                                                              |#######
#######| 1. Length of template string.  This length overrides the     |#######
#######|                                @S function.                  |#######
#######| 2. @S function.  The @S function works if the character      |#######
#######|                  string is longer than the length specified  |#######
#######|                  by @S<Uint-const>.  Otherwise the @S value  |#######
#######|                  is ignored.                                 |#######
#######| 3. Length of the unmodified character string.                |#######
#######| ------------------------------------------------------------ |#######
#######| SAY will display DATE data in 8 or 10 characters, depending  |#######
#######| on the status of the SET CENTURY flag.                       |#######
#######| ------------------------------------------------------------ |#######
#######| Logical data is displayed in a width of one column.          |#######
#######| ------------------------------------------------------------ |#######
#######| Characteristics of a numeric value are considered in the     |#######
#######| following priority to calculate the display width of         |#######
#######| numerical column:                                            |#######
#######|                                                              |#######
#######| 1. Width specified in numeric expression.                    |#######
#######| 2. Width specified by template.                              |#######
#######| 3. Width of resultant character string if > 10.              |#######
#######| 4. Column width set to 10.                                   |#######
#######+--------------------------------------------------------------+#######
##############################################################################

See Also: @ @...?? PICTURE FUNCTION
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson